• JoliPhone is a phonebook. It can hold several lists always instantly available, and dial the numbers automatically.
• JoliPhone can also print the lists, or print an envelope with the name and address currently selected in the list.
• JoliPhone dials through an external device, which can be:
- any modem that understands Hayes commands,
- any device that can receive Hayes commands at low or high speed from the Macintosh serial port,
- a Minitel with dialing capability (2, 10, 10b, 12…).
• JoliPhone can also send arbitrary character strings to either serial port (“macro” mode), without disturbing a terminal program concurrently using the same port.
Lists of names and numbers
• JoliPhone can open up to 10 lists simultaneously. The maximum size of a list may vary depending of its content (see below). The occupied part in percents is displayed in the “about” dialog. The search operation can be performed on all the lists automatically.
• The lists can be anywhere, even on a remote volume on the network, which lets several users share common lists, and still keep private lists on their own Macintosh.
• When you launch JoliPhone for the first time, it creates its own folder within the System Folder, called “JoliPhone Data”. Inside this folder, it will create its Preferences file, and a first list, empty, named “Main List”. You can close and throw away this default list, or rename it, or move it elsewhere on your disk: the only condition is that there must be always at least one list open, so you must create at least a second list to be able to close that default “Main List”.
• The lists are plain TEXT documents. The fields are separated with tabs, each entry being ended by a return. This file format makes transferring data from or to JoliPhone fairly easy. It's very simple, for instance, to create a JoliPhone file from an HyperCard stack (see below).
• Users of JoliPhone version 1 can convert their old data file to the new format using the “JPhoneList Converter” utility. If you don't have it, you'll find below an HyperCard script that will perform the same conversion.
Editing a list
• To edit a list, you must click on the small padlock to open it and unlock the list. When the list is unlocked, the Edit menu items are enabled.
• Select “New” to create a new entry in the list, or “Modify” to modify the selected item. You can also cut, copy and paste an item to move it entirely from a list to another one.
• Each entry has nine fields: the name, up to three numbers, each carrying its own label (home, office, fax…), the address, and a notes field. The maximum length of a field is 240 characters.
• Within a number, the significant characters change upon the mode used:
- If the dialer is a Minitel, only the digits 0 to 9 and the characters #, * and C are significant, any other characters are ignored. You may use any decorative separators, as in 123-45-67, 123/45/67, 123 45 67 or even 1234567. To obtain a pause in the dialing, you must setup properly the Minitel, please refer to the Minitel's manual.
- If the dialer is a modem, there is one more significant character: the comma is used to obtain a pause in the dialing, as in the usual Hayes syntax. The pause is very useful to wait for an outside tone, or to dial international numbers. The length of the pause depends on your modem, if it's not long enough, you can add a second comma to extend it.
- The syntax used in the previous version of JoliPhone (‘<’ and ‘>’) is still supported, but using it is discouraged because it diminishes the readability of the printed numbers. The result will be exactly the same replacing the ‘<’ by a comma, and the ‘>’ by two commas in a row.
- The ‘C’ (or ‘c’) at the end of a number will tell the modem (or the Minitel) to wait for a carrier after dialing, and connect.
- In the “macro” mode (see below), ALL the characters in the number are significant.
• Despite the “tab-tab-return” format, you can type returns within fields, which will make your addresses look much better. In the files, those “internal” returns are converted to ‘¬’. Of course, you must NEVER use this ‘¬’ character, else unpredictable results may occur.
• If the list has been modified, it is automatically saved when you click again on the padlock to lock it, or when you select another list, or when you quit JoliPhone.
Running JoliPhone
• JoliPhone is quite self-explanating: just walk in the menus and dialogs…
• Still, there are a few commands that you may find useful to know:
- Enter or Return dials the selected number. If there are more than one number, the selected button is pointed by a small arrow. Type the Tab key to move it to the next button.
- The Backspace key is a very convenient keyboard equivalent for the “Hangup” button. For historical reasons, command-period is still supported too.
- Option-Enter or option-Return display a dialog in which you can type a number to dial it directly, without putting it in the list.
- Double-clicking a name dials the first number.
- Typing the first characters of a name will select automatically the first matching name in the list (exactly as in the standard file dialog).
• In every dialogs, the standard keyboard equivalents (command X/C/V) are active where appropriate, and command-period is an equivalent to Cancel.
• If you delete an entry, you'll be asked to confirm the deletion. This alert is bypassed if you hold the Shift key when selecting “Clear” in the menu. The alert doesn't appear if you Cut instead of Clear, because in case of an error the cut item can be immediatly pasted back, so the situation is not worth an alert.
Printing an envelope
• JoliPhone can print an envelope with the name and address currently selected in the list. The text can be moved freely on the envelope rectangle.
• If you put a picture (PICT) in the clipboard, you may paste it on the envelope (a logo, your name and address, add what you want…) and also move it freely anywhere on the envelope. The picture is automatically saved by JoliPhone and reused all the time, until you remove it or change it.
—> The picture printing will be better if the picture comes from a “draw” program than from a “paint” program. A “paint” picture remains at the screen's resolution, a “draw” picture will fully use the printer's resolution which is always better.
—> If the picture has colors, the colors will be converted to grey levels by the PostScript LaserWriter with recent drivers. The picture should print with its full colors if you have a color printer.
Printing a list
• You can move the fields freely on the page using the grid on top, and select the fields you need to print.
• The vertical spacing can be constant or relative. The relative spacing usually saves a few trees when printing. The constant spacing may be useful for printing on labels.
• The top and bottom margins can be moved by clicking the small black squares on the right of the page, in the “Print the list” dialog.
• The page rectangle shown is only the printable area on the paper. Physical paper margins (non printable) are not shown.
Installing JoliPhone
• Despite its new look, JoliPhone is still a Desk Accessory! The application that contains it is only a “shell”, it gives to JoliPhone a more practical environment for MultiFinder or the System 7. Under System 7 or more, simply use the application as it is.
• Under System 6, if you use MultiFinder, the best is to use the application as it is. You can “take out” the DA from its shell and install it like any other DA, but as JoliPhone needs more memory than the Calculator, you must give it that memory! See below the details for optionally installing JoliPhone as a DA.
• JoliPhone requires a System 6.0 to work. The 6.0.5, as a minimum, is recommanded.
Shareware
• JoliPhone is a shareware, it is not free. You can try it as long as you feel you are still trying it, but the printing functions are disabled until you become a registered user and pay the fee. Select the “Shareware” item in the “phone” menu, and follow the instructions in the dialog to print a registration form.
• Don't forget to fill the form with your name and address. Send the form and payment ($35 per copy) to:
Benoît Widemann
68, avenue d'Italie
75013 Paris
France
• You will receive a serial number to personnalize JoliPhone, enable the printing functions and make the “shareware” dialogs disappear. You'll be also informed by mail or e-mail of the future evolutions of this program, and of the availability of new versions.
• The upgrade is free for the registered users of version 1, though the registration must have occured before June 1 1991. Else, the upgrade is $15, that is, the difference of the fees between the two versions. Registered users can just ask for their serial number for free, by mail or e-mail (see my e-mail addresses at the end).
• JoliPhone can be copied, given, distributed by any way, though I would be pleased if those four conditions are respected:
1) That distribution must remain free, except for the downloading time from a network or BBS. “Freeware” merchants can forget it, thank you. Any distribution on a non-free medium must obtain my permission first.
2) The package must remain complete, that is: JoliPhone, this text, and the Converter.
3) All those parts must not be modified in any manner. You can change whatever you like, at your own risks, but please DO NOT distribute those changes without my permission. This also applies to localization or translation to another language.
4) No copyright can be added to the existing one. In case it is distributed on a non-free medium, the word “shareware” and the copyright must clearly appear upon any mention of JoliPhone.
Converting the version 1 file
• JoliPhone version 1 maintained the list into a file named “JPhoneList”, located in the System Folder. The “JPhoneList Converter” utility reads that file and creates a new file with the new format, which you can open directly from JoliPhone 2. If you have the Converter, use it and skip this chapter. Else, you can very easily convert it using HyperCard. Follow those instructions step by step:
• Launch HyperCard (any version). In the File menu, select “New Stack”, give whatever name to the new stack. You arrive on an empty screen, that is the new stack you have just created.
• In the Objects menu, select “New Button”: a button appears. Double-click the button, a dialog appears: click the “Script” button in this dialog.
—> If there is no Object menu, type command-M to show the Message Box, then type in it “set userlevel to 5”. The menu Objects should appear in the menu bar.
• The script editor opens, containing the following default text:
on mouseUp
end mouseUp
Select those 3 lines, then delete them by pressing the Backspace key. Copy the following script and paste it, then replace "HD40" and "System Folder" in the first two lines by the name of your hard disk and of your System Folder, precisely.
on mouseUp
put "HD40:System Folder:JPhoneList" into oldFile
put "HD40:Main List (New Format)" into newFile
open file oldFile
read from file oldFile for 2 -- skip first two bytes
open file newFile
put 0 into count
set cursor to watch
repeat forever
read from file oldFile until return
if it is empty then exit repeat -- end of conversion
add 1 to count
put count -- displays conversion progress
put char 1 to 26 of it into name
repeat while last char of name is space
delete last char of name
end repeat
put empty into phoneNumber
put 27 into i
repeat forever
if char i of it is tab then
put true into commentPresent
exit repeat
else if char i of it is return then
put false into commentPresent
exit repeat
end if
if char i of it is "<" then -- short pause
put "," after phoneNumber
else if char i of it is ">" then -- long pause
put ",," after phoneNumber
else
put char i of it after phoneNumber
end if
add 1 to i
end repeat
if commentPresent is true then
put empty into comment
add 1 to i
repeat forever
if char i of it is return then exit repeat
put char i of it after comment
add 1 to i
end repeat
end if
write name & tab & tab to file newFile
if commentPresent is true then
write comment to file newFile
end if
write tab & "Phone:" & tab & phoneNumber & tab¬
& tab & tab & tab & return to file newFile
end repeat
close file oldFile
close file newFile
put empty
answer "The conversion is done."
end mouseUp
• After pasting that script and closing it, select the “hand” tool in the Tools menu, then click the button to execute the script. The resulting file will be located at the “root” level of your disk, named “Main List (New Format)”. You can move it wherever you want, then open it with JoliPhone 2.
• WARNING!! Do not open the old “JPhoneList” with JoliPhone 2, else unpredictable results may occur, specially if you try to edit it. You may end up to a totally unreadable file. This warning is dedicated to those nice users who read the manuals we suffer so much to write. (grin)
Version 2 file and clipboard format
• JoliPhone now uses TEXT files in simple “tab-tab-return” format. The fields are separated with a tab, the entry is terminated with a return. The maximum length of a field is 240 characters. The order of the fields in the file is: name, address, notes, label 1, number 1, label 2, number 2, label 3, number 3. The total length of all the occurences of a single field in a list (i.e. all the names, or all the addresses, or all the notes) must not excess 32767 characters, but the overall size of the file is not limited, neither the number of entries in a list.
• In “unlocked” mode, you can copy/paste ONE entry between two lists, or between JoliPhone and another application, but it's important to remember that JoliPhone permits using returns inside the fields and converts them to ‘¬’: the entry in the clipboard has this format. Conversely, in “locked” normal mode, there are no tabs in the clipboard and the returns within the fields are left as they are, the fields selected in the “Copy Setup” dialog are simply separated by a return.
Macros
• You can force JoliPhone to send all the characters of a “number” field to the serial port, which is very useful for adding “macros” functionalities to a terminal program. JoliPhone will not “steal” the serial port from the terminal, and will use the serial setup of the terminal instead of its own setup.
• The macro syntax is very simple: if the name starts with a ‘/’ or a ‘\’, the content of the number field is a macro and all its characters are sent (normally only digits are sent, see above). The slash must prefix the NAME and not the number. Here are some samples:
Name: Number :
/ Send a control-C ^C
/ My Secret Password USE_WITH_MS_APPS_AT_YOUR_OWN_RISKS^M
• Within a macro, you can insert control-characters using the ^ before an alphabetic letter: ^C = ctrl-C, ^A = ctrl-A, ^M = return… The Escape character can be entered using the top left key of the numeric keypad if your keyboard has no “esc” key (Mac Plus).
• The macros names starting with a slash will appear on top of the list, those starting with a backslash will appear at the bottom. There is no other difference. Macros, as names, are automatically sorted in alphabetic order.
Optional installation as a DA (system 6 only)
• To “take out” the DA from its application-shell, use Font-DA Mover the following way:
- Launch Font-DA Mover.
- Close the open list, that shows the fonts in your System file.
- At the top of the window, click the “Desk Accessories” radio-button.
- Click the “Open” button while holding down the Option key.
- Select the JoliPhone application and open it: JoliPhone appears in the left list.
- In the right list, click on the “Open” button, then click on “New”. The “open” dialog is then replaced by a “save” dialog asking for a file name. Type “JoliPhone DA” and click the “Create” button.
- Select JoliPhone in the left list, then click the “Copy” button.
- Quit Font-DA Mover. You have now a DA “suitcase” containing JoliPhone, you can install it as any DA.
• If you don't use MultiFinder, there's nothing special to note, except avoid opening JoliPhone if the current application has very little free memory. JoliPhone needs about 64K free to open, browse the lists and dial, but it needs about 80K to open the dialogs and edit the lists, and at least 128K to print. Those values are only indicative: if the lists are small, the amount of needed memory can be much smaller.
• Under MultiFinder (system 6), the first time you launch JoliPhone, it will propose to increase the amount of memory allocated to the DAs by MultiFinder. After that, JoliPhone will have the memory it needs (for techs, it just changes the SIZE resource in the DA Handler). If the operation fails for any reason, or if you throw away JoliPhone DA and want to go back to the normal allocation for DAs, you must trash the file “DA Handler” in the System Folder and replace it by a fresh copy from your master System diskette.
• Under System 7 or more, use the application. The DA is totally useless and will not accept to run. You may create an alias to JoliPhone and put it in the Apple Menu Folder to recover the instant availability of the DA with the application.
